定义

POST https://api.pingxx.com/v1/batch_transfers

$batch_tr = \Pingpp\BatchTransfer::create();

public BatchTransfer create();

此语言 SDK 暂不支持该接口。

pingpp.batchTransfers.create();

此语言 SDK 暂不支持该接口。

func ExampleBatchTransfer_new();

public static BatchTransfer alipayBatchTransfer(String appId) {}

请求示例

curl https://api.pingxx.com/v1/batch_transfers \
-H "Content-Type: application/json; charset=utf-8" \
-H "Pingplusplus-Signature: SIGNATURE" \
-H "Pingplusplus-Request-Timestamp: 1476067085" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC: \
-d '{
    "amount": 8000,
    "app": "app_ribgW1n2SOqcPxn1",
    "batch_no": "2016101010380007",
    "channel": "alipay",
    "description": "付款说明",
    "recipients": [
        {
            "account": "account01@alipay.com",
            "amount": 5000,
            "name": "张三"
        },
        {
            "account": "account02@alipay.com",
            "amount": 3000,
            "name": "李四"
        }
    ],
    "type": "b2c"
}'

try {
    $batch_tr = \Pingpp\BatchTransfer::create(
        [
            'amount'      => 8000,
            'app'         => APP_ID,
            'batch_no'    => uniqid('btr'),         //批量退款批次号，3-24位，允许字母和英文
            'channel'     => 'alipay',              //
            'description' => 'Your Description',    //批量退款详情，最多 255 个 Unicode 字符
            'recipients'  => [                      //需要退款的  charge id 列表，一次最多 100 个
                [
                    'account' => 'account01@alipay.com',
                    'amount'  => 5000,
                    'name'    => '张三'
                ],
                [
                    'account' => 'account02@alipay.com',
                    'amount'  => 3000,
                    'name'    => '李四'
                ]
            ],
            'type'      => 'b2c'
        ]
    );
    echo $batch_tr;                                 // 输出 Ping++ 返回的 batch transfer 对象
} catch (\Pingpp\Error\Base $e) {
    if ($e->getHttpStatus() != null) {
        header('Status: ' . $e->getHttpStatus());
        echo $e->getHttpBody();
    } else {
        echo $e->getMessage();
    }
}

public BatchTransfer create() {
    BatchTransfer obj = null;
    String orderNo = new SimpleDateFormat("yyyyMMddhhmmss").format(new Date()) + Main.randomString(7);
    Map<String, Object> params = new HashMap<String, Object>();
    params.put("app", appId);
    params.put("channel", "alipay");
    params.put("batch_no", orderNo); // 企业转账使用的商户内部订单号。wx(新渠道)、wx_pub 规定为 1 ~ 50 位不能重复的数字字母组合
    params.put("amount", 2000); // 订单总金额, 人民币单位：分（如订单总金额为 1 元，此处请填 100,企业付款最小发送金额为 1 元）
    params.put("type", "b2c"); // 付款类型，当前仅支持 b2c 企业付款
    params.put("currency", "cny");
    params.put("description", "your description");
    List<Map<String, Object>> recipients = new ArrayList<Map<String, Object>>();

    Map<String, Object> recipient = new HashMap<String, Object>();
    recipient.put("account", "user001@gmail.com");
    recipient.put("amount", 2000);
    recipient.put("name", "NAME");
    recipients.add(recipient);

    params.put("recipients", recipients);
    try {
        obj = BatchTransfer.create(params);
        System.out.println(obj);
    } catch (AuthenticationException e) {
        e.printStackTrace();
    } catch (InvalidRequestException e) {
        e.printStackTrace();
    } catch (APIConnectionException e) {
        e.printStackTrace();
    } catch (APIException e) {
        e.printStackTrace();
    } catch (ChannelException e) {
        e.printStackTrace();
    } catch (RateLimitException e) {
        e.printStackTrace();
    }
      return obj;
  }

此语言 SDK 暂不支持该接口。

pingpp.batchTransfers.create({
  "app": APP_ID，
  "batch_no": new Date().getTime().toString(), // 批量付款批次号
  "channel": "alipay", // 目前只支持 alipay
  "amount": 8000, // 批量付款总金额
  "description": "Your Description",
  "recipients": [
    {
      "account": "account01@alipay.com", // 接收者支付宝账号
      "amount": 5000, // 付款金额
      "name": "张三" // 接收者姓名
    },
    {
      "account": "account02@alipay.com", // 接收者支付宝账号
      "amount": 3000, // 付款金额
      "name": "李四" // 接收者姓名
    }
  ],
  "type": "b2c" // 付款类型，当前仅支持 b2c 企业付款
}, function(err, transfer) {
  if (err!=null){
    console.log("pingpp.batchTransfers.create fail:",err)
  }
  // YOUR CODE
});

此语言 SDK 暂不支持该接口。

func ExampleBatchTransfer_new() {
  recipients := []pingpp.BatchTransferRecipient{
    {Account: "account01@alipay.com", Amount: 5000, Name: "AA", Description: "Your description"},
    {Account: "account01@alipay.com", Amount: 5000, Name: "BB", Description: "Your description"},
  }
  params := &pingpp.BatchTransferParams{
    App:         "app_1Gqj58ynP0mHeX1q",
    Amount:      10000,
    Batch_no:    "2016101110380007",
    Channel:     "alipay",
    Description: "Your description",
    Type:        "b2c",
    Recipients:  recipients,
  }

  batchTransfer, err := batchTransfer.New(params)
  if err != nil {
    log.Fatal(err)
    return
  }
  content, _ := json.Marshal(batchTransfer)
  fmt.Println(string(content))
}

public static BatchTransfer alipayBatchTransfer(String appId)
{
    List<Dictionary<string, object>> list = new List<Dictionary<string, object>>();
    list.Add(new Dictionary<string, object>
    {
        // 必须，接收者支付宝账号。
        {"account", "account01@alipay.com"},
        //必须，金额，单位为分。
        {"amount", 5000},
        // 必须，接收者姓名
        {"name", "张三"},
        //可选，批量企业付款描述，最多 200 字节。
        {"description", "Your description"},
        // 可选，账户类型，alipay 2.0 渠道会用到此字段，取值范围： 1、ALIPAY_USERID：支付宝账号对应的支付宝唯一用户号。2088开头的16位纯数字组成。
        //                                                  2、ALIPAY_LOGONID（默认值）：支付宝登录号，支持邮箱和手机号格式。
        {"account_type", "ALIPAY_LOGONID"},
        //可选，订单号， 1 ~ 64 位不能重复的数字字母组合。
        {"order_no", "123456789"}
    });
    list.Add(new Dictionary<string, object>
    {
        {"account", "account02@alipay.com"},
        {"amount", 3000},
        {"name", "李四"},
    });

    var btParams = new Dictionary<string, object>
    {
        {"amount",8000},//批量付款总金额，单位为分。为 recipients 中 amount 的总和。
        {"app", appId},
        {"batch_no", "2017042810380015"},//批量转账批次号，3-24位，允许字母和英文
        {"channel", "alipay"},  //目前支持 渠道。支付宝：alipay，银联：unionpay，微信 JSAPI：wx_pub，通联：allinpay，京东：jdpay
        {"description", "Batch trans description."},
        {"type", "b2c"}, //付款类型 (当前 alipay、wx_pub 仅支持: b2c, unionpay、allinpay、jdpay 支持:  b2b、b2c)
        {"recipients", list}
    };

    return BatchTransfer.Create(btParams);
}

返回示例

{
  "id": "181610101014367590",
  "object": "batch_transfer",
  "app": "app_ribgW1n2SOqcPxn1",
  "amount": 8000,
  "batch_no": "2016101010380007",
  "channel": "alipay",
  "currency": "cny",
  "created": 1476067087,
  "description": "付款说明",
  "extra": {},
  "failure_msg": null,
  "fee": 0,
  "livemode": true,
  "metadata": {},
  "recipients": [
      {
          "account": "account01@alipay.com",
          "amount": 5000,
          "name": "张三",
          "transfer": "tr_jHWfvDnTKG0SiPmbfPbHW1eH",
          "status": "pending"
      },
      {
          "account": "account02@alipay.com",
          "amount": 3000,
          "name": "李四",
          "transfer": "tr_8u1yPK1eHWv9D08OePzDe1CK",
          "status": "pending"
      }
  ],
  "status": "pending",
  "time_succeeded": null,
  "type": "b2c"
}